package com.ssd.service;

import com.ssd.entity.Activity;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ssd.entity.dto.request.ActivityQueryForPageReqDTO;
import com.ssd.entity.dto.request.ActivitySaveReqDTO;
import com.ssd.entity.dto.response.ActivityInfoResDTO;
import com.ssd.entity.dto.response.SeizeCouponInfoResDTO;
import com.ssd.viewmodel.Pager;

import java.util.List;

/**
 * <p>
 * 优惠券活动表 服务类
 * </p>
 *
 * @author author
 * @since 2024-11-21
 */
public interface IActivityService extends IService<Activity> {

    /**
     * 保存或者修改活动
     * @param activitySaveReqDTO 活动信息
     */
    void save(ActivitySaveReqDTO activitySaveReqDTO);

    /**
     * 根据活动id查询活动信息
     *
     * @param id 活动id
     * @return
     */
    Activity queryById(Long id);

    /**
     * 活动撤销
     * @param id 活动id
     */
    void revoke(Long id);

    /**
     * 分页查询优惠券活动列表
     *
     * @param activityQueryForPageReqDTO@return
     */
    Pager<Activity> queryForPage(ActivityQueryForPageReqDTO activityQueryForPageReqDTO);

    /**
     * 用户端抢卷列表
     * @param tabType 类型
     * @return
     */
    List<SeizeCouponInfoResDTO> queryForListForCache(Integer tabType);

    /**
     * 活动预热，写入redis
     */
    void preHead();

    /**
     * 定时更新活动状态
     */
    void updateStatus();


    /**
     * 从缓存中查询活动信息
     * @param id 活动id
     * @return
     */
    ActivityInfoResDTO getActivityInfoByIdFromCache(Long id);

    /**
     * 扣减库存
     * @param id 活动id
     */
    void deductStock(Long id);

}
